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BF RE |, 


李 明 涛 123, 


a 


K he 


fg 122 


于 林 123, 
FT KR 1, 


1,2,3 
’ 


C.F EE 
GA 散 裂 


ay 
学 


中 子 源 科学 中 心 ， 广 东 东 莞 523808; 


院 高 能 物理 研究 所 ， 北 京 100049; 


加 


3. 中 


科学 院 大 学 ， 北 京 100049; ) 


摘要 : EPICS 控制 软件 广泛 应 用 于 粒子 加 速 


PV 的 数量 从 几 万 到 上 
计 和 和 
操作 日 志 以 及 I0C 状态 、 
用 Web 技术 ， 服 务 端 
周期 执 
中 发 挥 了 


重要 作用 。 


万 不 等 ， 


a 


发 了 EPICS PV 信息 平 
IOC 网 络 信 


行 的 程序 采用 Python 语言 开发 。 


关键 词 : EPICS; PV; 


中 图 分 类 号 : 
实验 物理 和 工业 控 和 
大 科学 装置 的 控 


在 中 国 散 裂 


TL503.6 


il] Ae (EPICS) 已 i 
制 系统 具有 的 标准 模型 ， 有 具 
il] ABU, 


子 源 CCSNS) 中 加 速 器 控制 


Node. js 运行 


快速 查询 | 
rS 


a 


NY 9 


并 


器 等 大 型 科学 实验 装置 。 根 据 
PICS PV 的 相关 信息 ， 可 提升 加 速 
在 统一 的 用 户 界 面 中 查询 PV 列表 、 


时 状态 、 


将 这 些 信 


综合 


息 关 联 在 一 起 ， 实 现 展示 。 


环境 


4 Hill AS; CSNS 


Tri 


有 可 移植 性 、 


目前 ， 


逐渐 成 为 加 速 器 控 人 


发 以 及 结合 EPICS 社区 已 有 的 软件 模块 ， 


司 ， 其 EPICS 
效率 。 为 此 ， 设 
历史 数据 、 
平台 的 用 户 界面 
网 络 信 ， 


SK 


BARS 


息 平台 已 应 用 于 CSNS 加 速 


EPICS PV 信 


文献 标志 码 : A 


判 系统 的 一 个 主流 的 软件 框架 ， 
可 裁减 性 以 及 可 重用 性 特点 ， 被 用 于 


可 互 操 作 性 、 


和 十 万 个 PV， 
庞大 的 PV 给 运行 维 
PGI A Fee 
PV iar 


E 


连接 的 交换 机 端 


护 带 


1% 


1 总 体 设计 


平台 ES 


来 了 挑战 。 为 提 
基于 Web 技术 开发 ， 使 
FE 人 、 所 属 系统 、 实 时 数值 、 历 史 | 
等 , 可 以 实现 对 PV 的 相关 信 ， 
支持 利用 IOC 名 查询 包含 的 PV 列表 


H 


高 CSNS HEARE thi 


1 线 、 操 作 记 录 ， 


系统 中 ， 目 前 


JÄ 


4 


1 系统 的 信息 化 水 平 , F 


IOC 的 运行 状态 、 


=e 


和 操作 记录 ; 


P> 
综合 


进行 综合 查询 , 例如 : 支持 利用 PV 名 查询 所 属 
支持 按 交 换 机 的 端 


ay 


a 


EPICS PV 信息 平 
台 采 用 三 层 架 构 ， 


协议 进行 信息 交互 。 


5 


即 前 


口 日 


p 


在 统一 的 用 户 界面 : 
端 EPICS IOC 应 用 、 


前 端 EPICS IOC 应 


收 稿 日 期 : 2023-07-21; 
基金 项 目 : 中 国 科 学 院 青 


通讯 作者 : 


修订 日 期 : 2023-10-23 
年 创新 促进 会 (Y9291420K2) 
作者 简介 : 薛 康佳 1991-， 男 ， 硕 士 ， 籍 贯 广东 兴 宁 人 ， 实 验 师 ， 


综合 查询 与 PV 相关 的 各 类 信息 , 其 总 体 架构 如 图 
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它们 运行 于 分 布 在 加 速 器 不 同 区 域 的 嵌入 式 PLC、 工 控 机 、 服 务 器 或 虚拟 化 环境 中 ， 如 此 数量 
发 了 EPICS PV 信息 平台 
浏览 器 访问 ， 支 持 查询 EPICS PV 及 IOC 相关 的 各 项 信息 ， 包 括 
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包括 标准 的 EPICS IOC 和 PV Gateway， 通 过 运行 在 EPICS IOC 中 的 CaPutLog 和 


RecCaster 模块 ， 分 别 为 中 间 数 据 服 务 层 提 
务 层 中 各 功能 模块 独立 运行 , 因此 易于 横向 
块 的 运行 。 最 上 层 为 平台 的 显示 层 ， 提 供 
展示 。 为 支持 跨 平台 使 
利用 REST API 和 WebSocket API 访问 服务 层 的 数据 外。 
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Fig. 1 Overall structure 
图 1 总 体 架 构 
通过 配置 防火 墙 规则 ， 平 台 同时 支持 在 控制 网 络 和 园 


地 址 和 端口 号 ， 该 平台 
的 服务 层 软 件 ， 因 
问 的 安全 性 。 


2 功能 模块 设计 


采用 Nginx 作为 反 向 代理 服务 器 


EPICS PV 平台 共 包 括 6 个 主要 功能 模块 ， 分 别 为 PV 列表 模块 、 实 
息 模 块 ， 模 块 之 间 的 数据 通 j 


PV 操作 日 志 模 块 以 及 IOC 状态 、IOC 网 络 信 
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户 访问 信息 ,平台 使 用 Web 技术 实现 展示 和 检索 , Web 前 端 基于 Vue.js HES, 采用 Prime Vue 


组 件 库 开发 用 户 界面 ，Web 后 端 则 基于 Node.js 运行 环境 中 开发 。PV 列表 模块 使 用 ChannelFinder 采集 PV 信 
息 ， 并 把 数据 存储 在 Elasticsearch 中 ; PV 操作 日 志 模块 利用 CaPutLog 和 Logstash 收集 PV 的 操作 日 志 ， 把 数 


据 存 储 在 Elasticsearch 中 ; 实时 数据 获取 模块 利用 PV Web Socket 获取 PV 及 IOC 的 实时 状态 ， 历 史 数 据 访问 
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的 信息 包含 PV 名 、 所 属 IOC 名 、 所 属 系统 、 责 外 
经 常 要 使 用 到 的 数据 。CSNS 没有 使 用 自 
护 所 负责 的 PV， 当 某 个 PV 出 现 问题 导致 无 法 连接 时 ， 加 速 器 运行 人 
任 人 ， 然 后 通过 责任 人 获知 PV 所 属 的 IOC 和 所 在 位 置 才能 做 进一步 处 型 
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接 ， 根 据 PV 名 即 可 定位 到 维护 所 需 的 责任 人 、IOC 名 称 和 IP 等 信息 

EPICS PV 信息 平台 平台 使 用 ChannelFinder 实现 PV 列表 的 采集 ，PV 列表 采集 软件 框图 如 图 2 所 示 。 
ChannelFinder 可 实现 EPICS PV 的 目录 服务 ， 该 软件 由 ChannelFinder Service、 客 户 端 库 和 RecSync 三 部 分 
组 成 ， 其 中 RecSync 实现 自动 上 传 PV 列表 ，ChannelFinder Service 实现 REST 风格 的 Web 服务 。 

RecSync 包含 RecCaster 和 RecCeiver 两 个 应 用 , 其 中 RecCaster 应 用 运行 在 IOC 中 。IOC 启动 后 RecCaster 
模块 自动 上 传 本 IOC 包 含 的 PV 列表 到 RecCeiver, 然后 RecCeiver 调用 pyCFClient 上 传 PV 列表 到 ChannelFinder 
Service， 最 后 将 数据 存储 到 ElasticSearch. 

ChannelFinder 提供 了 API 用 于 读 取 和 修改 PV 列表 ， 但 是 无 法 完全 满足 本 平台 的 需求 ， 比 如 : 不 能 直接 
获取 PV 所 在 的 IOC 名 和 IP 地 址 等 的 列表 。 因 此 ， 开 发 了 专门 的 Web 接口 ， 从 ChannelFinder Service 的 API 
获取 PV 列表 ， 从 ElasticSearch9 的 API 获取 IOC 4. IP 地 址 以 及 所 属 系统 和 子 系统 的 列表 ， 最 终 把 所 有 信息 
进行 整合 显示 。 从 ElasticSearch 获取 列表 采用 聚合 查询 方式 ， 语 句 为 


{"size":0,"aggs":{"my_tags":{"nested":{"path":"properties"},"aggs":{"my_filter":{"filter":{"terms":{ "properties. 


name":[code]}},"aggs":{"my_tags_values":{"terms":{"field":"properties.value","size":10000}}}}}}}}, 其 中 code 是 
变量 ， 例 如 code 为 iocid 时 查询 IP 地 址 列表 ， 为 hostName 时 查询 IOC 的 主机 名 列表 。 
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Fig. 2 Block diagram of PV information query 


图 2 PV 信息 采集 框图 


2.2 PV 实时 状态 与 历史 数据 

PV 实时 状态 与 历史 数据 是 监测 加 速 器 运行 状态 所 需 的 基础 信息 ， 实 时 状态 即 PV 的 实时 数值 和 报警 状态 
等 动态 信息 ， 历 史 数 据 是 加 速 器 运行 过 程 中 的 PV 归档 数据 。EPICS PV 信息 平台 集成 了 PV 实时 状态 和 历史 
数据 查询 功能 ， 在 用 户 接口 Web 页 面 点 击 相应 的 按钮 ， 支 持 弹 窗 显 示 所 选 PV 的 实时 状态 ， 或 跳 转 页 面 查询 
历史 数据 。 

RFC 6455 中 定义 了 WebSocket API 和 协议 00， 提 供 了 浏览 器 与 服务 器 之 间 的 双向 的 、 全 双 工 的 通信 通道 ， 
使 得 浏览 器 应 用 与 服务 器 进行 双向 通讯 时 不 必 同 时 打开 多 个 HTTP 连接 。 利 用 PV Web Socket (PVWS) 模块 
00 可 以 实现 使 用 EPICS Channel Access 协议 访问 PV， 同 时 提供 WebSocket 接口 供 Web 页面 进行 访问 ， 这 样 就 
可 以 实现 通过 Web 页 面 监测 PV 的 实时 状态 。 

EPICS PV 信息 平台 的 PV 实时 状态 查询 软件 框图 如 图 3 所 示 ，Web 网 页 与 PVWS 建立 连接 后 ，Web 网 页 
向 PVWS 发 送 要 订阅 的 PV 列表 ，PVWS 将 按 配置 的 周期 主动 推送 订阅 PV 的 实时 状态 给 Web 页 面 ， 包 括 数 
值 与 报警 状态 等 信息 。 有 具体 流程 是 当 用 户 点 击 某 个 PV 的 实时 状态 按钮 时 ， 使 用 JavaScript 程序 创建 与 PVWS 
连接 的 WebSocket 对 象 实例 ， 建 立 连接 后 利用 WebSocket 的 send 方法 发 送 订 阅 PV 的 请 求 ， 例 如 发 送 
{"type":"subscribe","pvs":["PV_Name"]}, PVWS 将 返回 格式 如 

{"type":"update","pv":"PV_Name","readonly":true,"seconds": 1663920701 ,"nanos":367890532,"units":"V","prec 


ision":2,"min":-5,"max":5,"warn_low":-3,"warn_high":3,"alarm_low":-4,"alarm_high":4,"severity":"MAJOR","value 


":4.7} 的 JSON 数据 ， 程 序 接收 到 数据 后 根据 value. severity 等 


属性 修改 Web 网 页 显示 的 内 容 。 


由 于 IOC 的 网 络 连接 数 过 多 时 存在 性 能 问题 ， 平 台 使 用 EPICS PV Gateway! 2E Jy PVWS 与 IOC 的 中 继 ， 
可 减少 客户 端 到 TOC 的 连接 数 ， 且 通过 少量 的 PV Gateway 即 可 访问 加 速 器 的 一 百 多 个 IOC 中 PV. 

Archiver Appliance 是 EPICS 框架 下 目前 最 流行 的 历史 数据 存档 管理 软件 ， 该 软件 满足 百 万 量 级 PV 数据 
的 存储 ， 采 用 分 时 存储 技术 提高 系统 存储 速度 并 且 具 有 组 建 应 用 程序 集群 的 能 力 031。CSNS 加 速 器 使 用 EPICS 
Archiver Appliance 存储 PV 历史 数据 , 该 软件 自身 提供 了 Web 访问 页 面 , 通过 在 HTTP 的 请 求 中 添加 PV 名 称 
参数 查询 相应 PV 的 历史 曲线 , 在 EPICS PV 信息 平台 中 点 击 PV 历史 曲线 按钮 时 , 将 跳 转 到 Archiver Appliance 


的 Web 页 面 ， 从 而 实现 历史 数据 查询 功能 。 
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Fig. 3 Block diagram of real-time and historical data acquisition for PV 


2.3 PV 操作 日 志 


图 3 PV 的 实时 与 历史 数据 获取 框图 


PV 操作 日 志 通 常用 于 分 析 和 再 现 加 速 器 运行 过 程 中 对 PV 的 操作 记录 ，EPICS PV 信息 平台 提供 了 查询 


PV 操作 日 志 的 功能 ， 并 且 支 持 结合 IOC 的 IP 地 址 、 操 作 的 客 
PV 操作 的 记录 应 用 程序 分 为 IOC 端 和 服务 端 两 部 分 。IOC 


Access 写 操作 提供 日 志 记录 的 EPICS 支持 模块 ， 该 模块 将 以 文本 格式 发 送 CA 写 操作 的 日 志 到 一 个 远程 日 志 


户 端 、 操 作 时 间 等 多 种 方式 进行 检索 。 


端 采 用 CaPutLog 模块 , CaPutLog 是 为 Channel 


Noe 


服务 器 09; 服务 端 通常 采用 EPICS Base 包含 的 IOC Log 服务 端 程序 iocLogServer， 该 程序 接收 caPutLog 发 送 
的 消息 并 保存 到 文件 中 。 由 于 iocLogServer 使 用 文本 文件 保存 日 志 ， 需 要 专门 培训 的 人 员 才 能 读 懂 日 志 ， 查 询 
和 分 析 不 方便 ， 另 外 ，iocLogServer 不 提供 API 供 外 部 应 用 访问 。 

Logstash 是 一 个 开源 的 数据 收集 引擎 ， 能 够 从 多 个 数据 来 源 采 集 数 据 和 转换 数据 ， 然 后 将 数据 发 送 到 指定 
的 存储 库 中 05。EPICS PV 信息 平台 采用 Logstash 作为 PV 操作 日 志 的 服务 端 ，PV 操作 日 志 收 集 软件 框图 如 
图 4 所 示 。 通 过 编写 配置 文件 创建 Logstash Pipeline， 以 收集 各 个 IOC 发 送 的 PV 操作 日 志 ， 转 换 后 存储 到 
Elasticsearch 中 。Pipeline 文件 由 input、filter 和 output 三 部 分 构成 ， 在 input 使 用 top 插件 接收 事件 〈 即 操作 上 日 


用 户 可 以 通过 Web 页 面 直接 获取 所 有 PV 的 操作 日 志 ， 或 者 按 
索 。 


Logstash Pipeline 


a), 然后 由 filter 解析 文本 ,最 后 通过 output 将 操作 日 志 写 入 Elasticsearch。 利 用 Elasticsearch 提供 的 RESTAPL， 


IOC 名 、 客 户 端 、IP 地 址 及 操作 时 间 等 进行 检 


Elasticsearch Web Page 


Fig. 4 Block diagram of PV 


2.4 IOC 状态 监测 


Fi 


图 4 PV 操作 日 志 框图 


put log 


大 型 加 速 器 通常 有 上 百 或 者 数 百 个 IOC, 由 于 不 是 所 有 IOC 的 PV 都 在 中 控 室 展示 ,， 当 加 速 器 停机 检修 恢 


复 时 ， 运 行人 员 无 法 快速 确认 是 否 所 有 IOC 都 恢复 运行 ， 因 
EPICS PV 信息 平台 提供 了 IOC 状态 信 


此 有 必要 对 IOC 是 否 恢复 运行 进行 检查 和 监测 。 


息 列 表 展 示 的 功能 ， 并 以 绿色 或 红色 背景 表示 IOC 是 否 正 常 运行 。 利 用 


本 功能 ， 运 维 人 员 ; 


所 示 。 该 模块 使 用 


PV 名 称 等 数据 保存 到 MongoDB 中 。 当 打 了 


通过 一 个 页 面 即 可 获知 所 有 IOC 的 运行 状态 ， 


以 确认 控制 系统 是 否 已 恢复 正常 运行 。 
IOC 是 否 运行 是 通过 监测 IOC 中 指定 的 PV 是 否 可 以 访问 实现 的 ， 该 功能 模块 的 总 体 设 计 和 数据 流 如 图 5 


Python 开发 了 专用 程序 ， 首 先 如 2.1 所 述 从 Elasticsearch 获取 IP 地 址 列表 ， 然 后 把 列表 中 
的 IP 地 址 作为 参数 逐个 从 ChannelFinder 获取 相应 的 PV 列表 ， 最 后 将 每 个 IOC 的 IOC 名 、 主 机 名 和 第 一 个 


IOC 状态 页 面 时 ， 首 先 ， 经 Web 后 端 程序 请 求 MongoDB 中 存储 


的 IOC 和 相应 PV 列表 ; Ala, Web 页 面 通 过 PYWS 连接 返回 的 PV 列表 ， 如 果 PYWS 无 法 连接 某 个 PV， 则 
说 明 该 PV 所 在 的 IOC RA; Ba, ZA Web 后 端 程序 和 PVWS 返回 的 数据 ， 在 用 户 界面 中 显示 IOC 的 


信息 和 状态 。 


2.5 IOC 网 络 信息 


EPICS PV 信息 平台 整合 了 ChannelFinder 中 存储 的 PV 的 IP 地 址 信息 和 交换 机 数据 ， 因 
IOC 主机 的 下 地址 ， 还 支持 查询 IOC 主机 的 MAC 地 址 、 连 接 的 交换 机 名 称 及 交换 机 端 
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Fig. 5 Block diagram of IOC state monitoring 


图 5 IOC 状态 监测 模块 框图 


为 了 动态 获取 交换 机 信息 ， 使 用 Python 开发 了 专 


i 程序， 利用 


Elo 


此 除了 文 持 查 询 


Telnet 协议 连接 各 交换 机 ， 获 取 CSNS 加 


速 器 核心 交换 机 的 ARP R, 以 及 所 有 交换 机 的 MAC 地 址 表 、 端口 状态 信息 , 将 处 理 后 的 数据 保存 到 MongoDB 


数据 库 


机 的 名 称 、IP 地 址 和 管理 账号 。 程序 使 用 netmiko 库 利 


。 以 锐 捷 交 换 机 为 例 ， 有 具体 实现 方法 如 下 : 在 Python 程序 中 ， 预 先 存 储 了 核心 交换 机 和 各 接 入 交换 
] Telnet 协议 连接 核心 交换 机 , 分 别 发 送 show arp, show 


mac-address-table 和 show interfaces description 命令 获取 核心 交换 机 的 ARP RMAC 地 址 表 和 交换 机 接口 信息 ; 


使 


] netmiko 集成 的 TextFSM 模块 将 返回 的 文本 数据 格式 化 为 程序 可 以 直接 处 理 的 JSON 数据 , 并 将 数据 处 理 


后 保存 到 MongoDB 中 。 与 核心 交换 机 类 似 ， 依 次 连接 每 台 接 入 交换 机 ， 获 取 MAC 地 址 表 和 交换 机 接口 信息 
并 保存 到 到 MongoDB 数据 库 中 。 当 打开 网 络 信息 查询 页 面 时 ，Web 后 端 程序 结合 MongoDB 中 各 交换 机 的 数 


据 ， 返 回 关联 好 的 IP. MAC 地 址 以 及 连接 的 各 级 交换 机 的 名 称 和 接口 。 软 件 框 图 如 图 


6 所 示 。 
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Fig. 6 Block diagram of dynamically obtaining switch information 


图 6 动态 获取 交换 机 信息 软件 框图 


3 应 用 情况 


EPICS PV 信息 平台 已 经 在 CSNS 加 速 器 部 署 使 用 ， 其 操作 界面 如 图 7、8 所 示 。 在 部 署 该 平台 后 ， 已 经 收 
集 了 CSNS 加 速 器 控制 系统 中 的 103 个 IOC 的 信息 ， 包 括 超 过 6 万 个 PV， 这 有 效 提高 了 CSNS 加 速 器 控制 系 
统 的 信息 化 水 平 ， 此 外 ， 还 有 部 分 设备 采用 LabVIEW、C# 等 程序 发 布 PV， 非 标准 IOC 无 法 编译 RecCaster 
模块 ， 因 此 暂 未 纳入 平台 管理 。 在 加 速 器 运行 过 程 已 经 出 现 数 次 个 别 PV 无 法 连接 的 情况 ， 利 用 平台 快速 查询 
到 了 该 PV 所 属 的 IOC. BEA. IOC 的 IP 地 址 以 及 连接 的 交换 机 端口 ， 这 大 大 提高 了 定位 问题 的 效率 ; F 
台 查 看 IOC 状态 的 功能 也 已 应 用 于 加 速 器 每 周 的 例 行 停机 检修 中 。 

CSNS 加 速 器 PV 信息 平台 


PV 信息 I0C 状 态 PV 操作 记录 


IOC: 103 个 ，PV: 66860 个 。 


pv 名 称 ocg = Pitit = RR = Fae = wea 操作 
022-10-17 加 
ACC_RFIS_CO::Air:Flow_M:ai ioniocRP61 10.1.205.13 CO Isc ree 29 © 二 = 
-10-17 = 
ACC RFIS CO:AirFlow Setao 。 ioniocRP61 10.1.205.13 co Isc ee @ 必 三 @ 


17:03:29 


Fig. 7 Home Page of CSNS cccelerator PV information platform 
图 7 CSNS 加 速 器 PV fa EOF GER 


正常 1oc: 103 个 ， 异 常 1oc: 0 个 。 网 络 信息 
RCS QS PSC fpsLRBT IOC IP: 10.1.205.13 
10.1.203.45 10.1.200.180 
PRPSC05 vxTarget IOC MAC: 0000.648d.4145 
更 多 信息 
核心 交换 机 端口 : AggregatePort 14 
RCS trim H PSC 接 入 交换 机 名 称 : ISH2928-1 

10.1.203.43 
ESSE 接 入 交换 机 端口 : GigabitEthernet 0/2 


更 多 信息 


Fig. 8 IOC status, network information page 
8 IOC 状态 、 网 络 信息 页 男 


4 结束 语 


在 大 型 加 速 器 控制 系统 中 ，EPICS IOC 数量 可 达 数 百 个 ，PV 数量 可 达 数 十 万 个 ， 涉 及 到 的 系统 和 工作 人 


员 众多 。 因 此 ， 信 息 化 建设 对 于 控制 系统 的 管理 维护 发 挥 着 重要 作用 。 本 文 设 计 并 实现 了 一 个 EPICS PV 信息 
平台 , 该 平台 提供 了 统一 的 用 户 界面 , 用 于 查询 PV 列表 、 实 时 状态 、 历 史 数据 、 操 作 日 志 以 及 IOC 状态 、IOC 
网 络 信息 。 同 时 ， 这 些 信 息 也 可 以 相互 调用 和 检索 。 平 台 采 用 了 主流 的 技术 方案 ， 易 于 移植 和 扩展 ， 可 应 用 于 
其 他 采用 EPICS 架构 的 控制 系统 。 
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Abstract: 


EPICS, a software tool extensively used in large-scale scientific experiments such as particle accelerators. Depending on the scale of 
the facility, the number of EPICS PV can range from tens of thousands to millions. The ability to swiftly retrieve information related to 
EPICS PV can notably enhance the operational efficiency and maintenance of particle accelerators. To address this requirement, we 
designed and developed the EPICS PV information platform. This platform provides a unified user interface that supports the querying of 
PV lists, real-time statuses, historical data, put logs, IOC statuses, and IOC network information. It integrates these data points to offer a 
comprehensive view. The user interface of the platform leverages Web technology, with the server-side developed in the Node.js 
environment. This is complemented by software modules from the EPICS community. In addition, programs for network information 
collection and other cyclical executions are developed using the Python language. At present, the EPICS PV information platform has 
been successfully implemented in the CSNS accelerator, where it has significantly contributed to its effective operation and maintenance. 
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